Skip to content

Conversation

@ryanmac
Copy link
Owner

@ryanmac ryanmac commented Jul 25, 2025

Summary

This PR addresses user feedback that the conductor-init.sh installer should create an initial discovery task for building the documentation map. Previously, the installer only created demo tasks without the critical [INIT] task needed to analyze the codebase.

Problem

The user reported:

"I ran the conductor-init.sh... However, I noticed it did NOT add an issue to prepare the documentation map. This is a new project, with barely any code or documentation, but it still should've build the documentation map. I expected it to create a critical issue (or otherwise highest priority) to build this map, and even generate missing documentation where possible."

Solution

Modified conductor-init.sh to create a high-priority "[INIT] Build documentation map and analyze codebase" task during installation. This task:

  • Has the highest priority as other tasks depend on it
  • Provides detailed instructions for creating .conductor/documentation-map.yaml
  • Includes objectives, success criteria, and process steps
  • Instructs to run generate-tasks-from-map.py after completion

Changes

  • Updated the "Creating demo tasks" section to "Creating initial tasks"
  • Added creation of the [INIT] documentation map task as the first issue
  • Set appropriate labels: conductor:task, effort:large, priority:high
  • Kept the existing demo tasks for additional starter work

Testing

  • Verified script syntax with bash -n
  • Confirmed the new issue creation command is properly formatted
  • Tested that the script maintains backward compatibility

Impact

New Code Conductor installations will now properly initialize with the critical documentation map task, ensuring AI agents have the context they need to understand the project and generate appropriate follow-up tasks.

🤖 Generated with Claude Code

The conductor-init.sh installer now creates a high-priority task for building the
documentation map during setup. This addresses user feedback that the installer
should create the initial discovery task that analyzes the codebase and generates
the critical .conductor/documentation-map.yaml file.

Changes:
- Added creation of "[INIT] Build documentation map and analyze codebase" issue
- Set as highest priority task that other tasks depend on
- Includes comprehensive task description with objectives and success criteria
- Task instructs to run generate-tasks-from-map.py after creating the map

This ensures new projects get proper initialization with the documentation map
that provides essential context for all subsequent AI agent tasks.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@ryanmac ryanmac merged commit 992c345 into main Jul 25, 2025
10 checks passed
@ryanmac ryanmac deleted the fix-conductor-init-documentation-map-issue branch July 25, 2025 18:26
ryanmac added a commit that referenced this pull request Jul 25, 2025
The installer now checks during upgrades if the critical [INIT] documentation map
task exists, and creates it if missing. This ensures existing projects that were
set up before PR #73 will get the documentation map task when they upgrade.

Changes:
- Added Step 6.5 to check for documentation map task during upgrades
- Only creates the task if it doesn't exist AND no map file exists
- Provides appropriate feedback for all scenarios
- Maintains backward compatibility with existing installations

This addresses the issue where upgrading Code Conductor doesn't create the
documentation map task that was added in PR #73 for fresh installations.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants